home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / opalvisn / adprsvr1.lha / ReadMe.doc < prev   
Text File  |  1993-07-04  |  5KB  |  131 lines
  1.  
  2.                  ADPro/MorphPlus OpalVision Saver v1.4
  3.  
  4.  
  5.                         INSTALLATION
  6.  
  7. To  install  the  saver, use the supplied Install script from the cli.
  8. First  make  sure  that you set the current directory to the directory
  9. where you extracted this archive.  You must specify the directory into
  10. which  ADPro  is  installed, if you have assigned ADPro:  then use the
  11. command.
  12.  
  13.        execute Install ADPro:
  14.  
  15. If  you  haven't  assigned  ADPro, then specify the path that contains
  16. ADPro,  if  the  path name does not end in ':' then you must specify a
  17. '/' after the path name, for example:
  18.  
  19.        execute Install dh0:graphics/adpro/
  20.        execute Install dh0:
  21.  
  22. NOTE:  If the installer tells you to reboot, then you must reboot your
  23. amiga before using the OpalVision Saver.
  24.  
  25.  
  26. TECHNICAL  NOTE:   You must have version 1.6 or later of opal.library,
  27. the install script will make sure of this.  If you find that the saver
  28. crashes, make sure you have version 1.6 or later by typing:
  29.  
  30.         version opal.library
  31.  
  32.  
  33.  
  34.                     SAVER DESCRIPTION
  35.  
  36. The  OpalVision  saver  gives  you control over the OpalVision display
  37. board  from  within ADPro or MorphPlus.  The saver allows raw 24bit or
  38. grey  scale  images  or  rendered  images  from 2 to 256 colours to be
  39. displayed.
  40.  
  41. When  the  Saver  is  activated, the OpalVision Saver control panel is
  42. displayed.   This control panel contains several button to control the
  43. image being displayed.
  44.  
  45. The  uppermost  button  indicates type of image to be displayed.  This
  46. button  allows you to switch between the raw 24bit or grey scale image
  47. and  the  rendered  image  if one exists.  The rendered image data can
  48. contain  1  to  8  bit-planes (2 to 256 colours) in a standard palette
  49. mapped  configuration.   That is, the rendered image data cannot be in
  50. one  of  the  rendering modes unique to the Amiga such as HAM, HAM8 or
  51. EHB.
  52.  
  53. Below  this  button  are  the resolution control buttons.  These three
  54. buttons  control  the  horizontal  resolution, vertical resolution and
  55. overscan  respectively.  These buttons are much the same as the screen
  56. control  buttons on ADPro's main screen.  The Overscan button controls
  57. both the hoizontal and vertical.
  58.  
  59. To view the image using the current settings, select the Image button.
  60. Once the image has been displayed, the saver will accept the following
  61. key commands:
  62.  
  63.         Del               : Toggle cross hair pointer on/off.
  64.         Arrow Keys        : Scroll display.
  65.         Shift - Arrow Keys: Scroll display in larger steps.
  66.         Alt - Arrow Keys  : Jump to the extremeties of the image.
  67.         n                 : Center screen under mouse pointer (if possible).
  68.  
  69. The  scroll  keys  are only applicable if the image is larger than the
  70. display screen size.
  71.  
  72. To exit the saver click the left mouse button and you will be returned
  73. to ADPro's main screen.
  74.  
  75. Note:   Any  changes made with the Color Balancing controls on ADPro's
  76. main  screen  will  effect the displayed image immediately without the
  77. need the re-render it or use the Apply Map Operator.
  78.  
  79.  
  80.                    AREXX INTERFACE
  81.  
  82. Syntax:                 SAVE FILENAME TYPE
  83.                         SAVE FILENAME TYPE SCREEN_TYPE STYPE
  84.                         SAVE FILENAME TYPE SCREEN_TYPE STYPE DURATION TICKS
  85.  
  86.  
  87. The  FILENAME parameter must be specified but is ignored by the saver.
  88. The  TYPE  parameter  is  also  required and defines the image type to
  89. display,  accepted values are RAW or IMAGE, SCREEN is not supported by
  90. the  saver.
  91.  
  92. If  the SCREEN_TYPE token is specified, it must be followed by a value
  93. indicating  the  display  resolution to use (STYPE), this value is the
  94. same  as  ADPro's  screen  type flags given in table 16.5 of the ADPro
  95. manual.  Allowable flags are:
  96.  
  97.                  Hires (1)
  98.                  Interlace (2)
  99.                  Horizontal Overscan (8) 
  100.                  Vertical Overscan (16)
  101.  
  102. Note  that  either  Horizontal  overscan (8) or Vertical overscan (16)
  103. will  put  the  display  into  overscan  mode.   If SCREEN_TYPE is not
  104. specified, the last selected display resolution will be used.
  105.  
  106. If  the DURATION token is specified, it must be followed by a duration
  107. in  ticks (fiftieths of a second) to display the image.  If TICKS is 0
  108. or  DURATION  is  not specified, the image will be displayed until the
  109. user clicks the left mouse button.
  110.  
  111.  
  112. Examples:
  113.  
  114. 1. Display Raw image data in hires-interlaced mode.
  115.  
  116. SAVE "X" RAW SCREEN_TYPE 3
  117.  
  118. 2. Display Rendered image data in lores-overscan for 2 seconds.
  119.  
  120. SAVE "X" IMAGE SCREEN_TYPE 8 DURATION 100
  121.  
  122.  
  123.  
  124.  
  125. The  OpalVision  saver  module  was written by Opal Technology, if you
  126. have  any  questions or problems please contact the OpalVision hotline
  127. on (310) 542-2226.
  128.  
  129.                                               Martin Boyd, OpalTech.
  130.  
  131.